home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / midi / mdFree.z / mdFree
Encoding:
Text File  |  1998-10-20  |  4.3 KB  |  67 lines
  1.  
  2.  
  3.  
  4. mmmmddddMMMMaaaalllllllloooocccc((((3333ddddmmmm))))                                                    mmmmddddMMMMaaaalllllllloooocccc((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mdMalloc, mdFree, mdCallMalloc, mdCallFree, mdSetAllocator - control
  10.      memory allocation for the MIDI library
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////mmmmiiiiddddiiii....hhhh>>>>
  14.  
  15.      ttttyyyyppppeeeeddddeeeeffff vvvvooooiiiidddd ****((((****mmmmddddMMMMaaaalllllllloooocccc____tttt))))((((ssssiiiizzzzeeee____tttt))));;;;
  16.  
  17.      ttttyyyyppppeeeeddddeeeeffff vvvvooooiiiidddd ((((****mmmmddddFFFFrrrreeeeeeee____tttt))))((((vvvvooooiiiidddd ****))));;;;
  18.  
  19.      mmmmddddMMMMaaaalllllllloooocccc____tttt mmmmddddMMMMaaaalllllllloooocccc;;;;
  20.  
  21.      mmmmddddFFFFrrrreeeeeeee____tttt mmmmddddFFFFrrrreeeeeeee;;;;
  22.  
  23.      mmmmddddCCCCaaaallllllllMMMMaaaalllllllloooocccc((((ssssiiiizzzzeeee____tttt lllleeeennnn))));;;;
  24.  
  25.      mmmmddddCCCCaaaallllllllFFFFrrrreeeeeeee((((vvvvooooiiiidddd ****aaaarrrrgggg))));;;;
  26.  
  27.      vvvvooooiiiidddd mmmmddddSSSSeeeettttAAAAllllllllooooccccaaaattttoooorrrr((((mmmmddddMMMMaaaalllllllloooocccc____tttt mmmmaaaalllllllloooocccc____ffffuuuunnnncccc,,,, mmmmddddFFFFrrrreeeeeeee____tttt ffffrrrreeeeeeee____ffffuuuunnnncccc,,,, vvvvooooiiiidddd ****aaaapppp))))
  28.  
  29. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  30.      mmmmddddMMMMaaaalllllllloooocccc and mmmmddddFFFFrrrreeeeeeee are pointers to memory allocation functions used by
  31.      the MIDI library.  The default implementations use the aaaammmmaaaalllllllloooocccc(3P)
  32.      library to implement an arena separate from the main heap used by
  33.      mmmmaaaalllllllloooocccc(3C).  This allows memory performance in the MIDI library to be
  34.      maintained in the presence of high malloc usage by an application.
  35.      mmmmddddMMMMaaaalllllllloooocccc is used by mmmmddddRRRReeeecccceeeeiiiivvvveeee(3dm) to allocate storage for incoming MIDI
  36.      system exclusive messages.  mmmmddddFFFFrrrreeeeeeee is used by the application to release
  37.      that storage.
  38.  
  39.      mdMalloc and mdFree are mp-safe.
  40.  
  41.      mmmmddddSSSSeeeettttAAAAllllllllooooccccaaaattttoooorrrr allows an application to override the any of the
  42.      following: mdMalloc (via _m_a_l_l_o_c__f_u_n_c), mdFree (via _f_r_e_e__f_u_n_c) or the
  43.      storage arena (via _a_p).  When using one's own arena, the default behavior
  44.      of the storage allocator may be changed via aaaammmmaaaalllllllloooopppptttt(3P).  If all three
  45.      are overridden, the behavior of the storage allocator is completely under
  46.      application control.
  47.  
  48.      mmmmddddCCCCaaaallllllllMMMMaaaalllllllloooocccc and mmmmddddCCCCaaaallllllllFFFFrrrreeeeeeee are routines used to call the current
  49.      allocation or deallocation routine, respectively.  These are actual
  50.      routines, not pointers.
  51.  
  52. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  53.      mdMalloc returns a pointer to a block of memory at least _l_e_n bytes long,
  54.      or NULL if no storage can be allocated.
  55.  
  56. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  57.      mdIntro(3dm), mdReceive(3dm)
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.